home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xm / XmeVirtualToActualKeysyms.z / XmeVirtualToActualKeysyms
Text File  |  1998-10-30  |  4KB  |  67 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmeeeeVVVViiiirrrrttttuuuuaaaallllTTTTooooAAAAccccttttuuuuaaaallllKKKKeeeeyyyyssssyyyymmmmssss((((3333UUUUXXXXNNNN))))IIIIXXXX SSSSyyyysssstttteeeemmmmXXXXmmmmVVVVeeeeVVVViiiirrrrttttuuuuaaaallllTTTTooooAAAAccccttttuuuuaaaallllKKKKeeeeyyyyssssyyyymmmmssss((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmeeeeVVVViiiirrrrttttuuuuaaaallllTTTTooooAAAAccccttttuuuuaaaallllKKKKeeeeyyyyssssyyyymmmmssss - Finds the physical keysyms
  10.           associated with a given virtual keysym.
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/XmP.h>
  14.           iiiinnnntttt XXXXmmmmeeeeVVVViiiirrrrttttuuuuaaaallllTTTTooooAAAAccccttttuuuuaaaallllKKKKeeeeyyyyssssyyyymmmmssss(
  15.           DDDDiiiissssppppllllaaaayyyy ****ddddiiiissssppppllllaaaayyyy,
  16.           KKKKeeeeyyyySSSSyyyymmmm vvvviiiirrrrttttuuuuaaaallllKKKKeeeeyyyyssssyyyymmmm,
  17.           XXXXmmmmKKKKeeeeyyyyBBBBiiiinnnnddddiiiinnnngggg ****pppphhhhyyyyssssiiiiccccaaaallllKKKKeeeeyyyyssssyyyymmmmssss);
  18.  
  19.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  20.           This page documents Motif 2.1.
  21.  
  22.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.           XXXXmmmmeeeeVVVViiiirrrrttttuuuuaaaallllTTTTooooAAAAccccttttuuuuaaaallllKKKKeeeeyyyyssssyyyymmmmssss determines which physical
  24.           keysym(s) and modifier(s) are associated with a given
  25.           virtual keysym.  A virtual keysym might match multiple
  26.           physical keysyms.  Therefore,
  27.           XXXXmmmmeeeeVVVViiiirrrrttttuuuuaaaallllTTTTooooAAAAccccttttuuuuaaaallllKKKKeeeeyyyyssssyyyymmmmssssreturns the number of physical
  28.           keysyms matched.  The returned physical keysym and modifiers
  29.           are stored in an array of XXXXmmmmKKKKeeeeyyyyBBBBiiiinnnnddddiiiinnnngggg structures.
  30.  
  31.           The XXXXmmmmeeeeVVVViiiirrrrttttuuuuaaaallllTTTTooooAAAAccccttttuuuuaaaallllKKKKeeeeyyyyssssyyyymmmmssss function allocates dynamic
  32.           memory to hold the _p_h_y_s_i_c_a_l_K_e_y_s_y_m_s array.  Your widget is
  33.           responsible for freeing the memory used to hold this array.
  34.           The amount of memory is equal to the number of physical
  35.           keysyms that are matched times the size of one XXXXmmmmKKKKeeeeyyyyBBBBiiiinnnnddddiiiinnnngggg
  36.           structure.
  37.  
  38.           _d_i_s_p_l_a_y   Specifies the display.
  39.  
  40.           _v_i_r_t_u_a_l_K_e_y_s_y_m
  41.                     Specifies the virtual keysym that is to be
  42.                     translated.
  43.  
  44.           _p_h_y_s_i_c_a_l_K_e_y_s_y_m
  45.                     Returns a pointer to an array of XXXXmmmmKKKKeeeeyyyyBBBBiiiinnnnddddiiiinnnngggg.
  46.                     The XXXXmmmmKKKKeeeeyyyyBBBBiiiinnnnddddiiiinnnngggg data type is a structure defined
  47.                     as follows:
  48.  
  49.           typedef struct {
  50.             KeySym        _k_e_y_s_y_m;  Modifiers     _m_o_d_i_f_i_e_r_s;} *XmKeyBinding;
  51.  
  52.      RRRREEEETTTTUUUURRRRNNNN
  53.           Returns the number of physical keysyms that correspond to
  54.           _v_i_r_t_u_a_l_K_e_y_s_y_m. A returned value of 0 indicates that no
  55.           physical keysyms matched _v_i_r_t_u_a_l_K_e_y_s_y_m.
  56.  
  57.      RRRREEEELLLLAAAATTTTEEEEDDDD
  58.           VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss(3).
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 10/24/98)
  64.  
  65.  
  66.  
  67.